Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Color Profile Messages

GXSetPrinterProfile

QuickDraw GX sends the GXSetPrinterProfile message to change the current color profile for a printer. Your override of the GXSetPrinterProfile message must match the following formal declaration:

OSErr MySetPrinterProfile (gxPrinter thePrinter,
            gxColorProfile oldProfile, gxColorProfile newProfile);

thePrinter

The printer object.

oldProfile

The profile that has been associated with the printer object.

newProfile

The profile to add to the list of profiles for a printer object.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

You can override the GXSetPrinterProfile message to change the current profile for a printer, to replace an existing profile that is associated with the printer object, or to remove a profile from the list of color profiles that are associated with the printer object.

The values of the oldProfile and newProfile parameters define what happens in response to this message, as shown in Table 4-3.

The actions of the GXSetPrinterProfile message

Value of oldProfile	Value of newProfile	Action taken
nil	nil	None
Valid	nil	oldProfile is deleted from the list of profiles associated with the printer object
nil	Valid	newProfile is added to the list of profiles for the printer object and becomes the current profile
Valid	Valid	oldProfile is deleted from the list of profiles, newProfile is added, and newProfile becomes the current profile for the printer object

The default implementation of this message modifies the list of profiles that are associated with the printer object, as shown in Table 4-3.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXSetPrinterProfile function is described in Inside Macintosh: QuickDraw GX Printing.

Color matching, color profiles, and color profile resources are described in Inside Macintosh: Advanced Color Imaging.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help